home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-1.iso / Files / Tele / Internet / RnMac1.3b4.sit / rnMac ƒ / rnMac 1.3b4.rsrc / TEXT_128_Help Text.txt < prev    next >
Encoding:
Text File  |  1994-06-15  |  18.2 KB  |  198 lines

  1.              rnMac  1.3b4
  2.                             written by Roy Wood
  3.                      cool icons by Ernst ‚ÄúPooh‚Äù Mulder
  4.  
  5.                                rrwood@io.org
  6.                     Roy_R._Wood@magic-bbs.corp.apple.com
  7.  
  8.                        ¬©1993 Silicon Angst Software
  9.                            7 Heyworth Crescent
  10.                         Toronto, Ontario, CANADA
  11.                                  M4E 1T6
  12.                              (416) 694-5927
  13.  
  14. rnMac is shareware, so if you use it, send $25 to me at the address listed above (please make out cheques to me, Roy Wood).  You know that UUPC/ ToadNews/ rnMac together will cost you a LOT less than uAccess, so support the authors of these fine shareware products, or there won't be any fine shareware products anymore....
  15.  
  16. I've been told that Eudora is now compatible with UUPC, so you might like to look at it if you're looking for a mail interface.  Many people swear by it, but I've not tried it yet.  Also, you might consider FernMail by Dave Platt or LeeMail by Lee Fyock....
  17.  
  18. And if you've got MacTCP and access to an NNTP server, check out MacSlurp!  It grabs news from the NNTP server for offline reading later....
  19.  
  20.  
  21. rnMac is a offline newsreader/mailer for Macintosh computers.  If you don't know what Usenet news is, you probably don't have much need for this program.  Contrary to what the name implies, this is not a port of ‚Äúrn‚Äù or any similarly-named newsreader.
  22.  
  23. There are a number of newsreaders available for the Mac, though most are intended for use with Mac TCP/IP and an NNTP news server (I think NewsWatcher can be used in demo mode to read from a local hard drive, and TheNews is now usable in a uucp context, too).  rnMac is intended for use on stand-alone Macs that get their newsfeed via something like UUPC and ToadNews.  rnMac doesn't know anything about modems, uucp, unbatching, or expiring; all it knows how to do is to read articles from a folder on your hard drive.
  24.  
  25. There's really not much to be explained about the use of rnMac.  Once you get your newsfeed working, you should be set to read news.  The only thing to fiddle with is the "rnMac SETTINGS" file‚Äî it should contain the following 'STR ' named resources, which you should set appropriately for your machine (use the ‚ÄúEdit rnMac Settings‚Äù option under the Edit menu to do this, or just use ResEdit).  Most of these are the same as the 'STR ' resources UUPC, Fernmail, and ToadNews use, so you're probably going to get good at setting these things.   With luck, these redundant resources will be centralized someday....
  26.  
  27. "NEWSFOLDER" - the FULL OR PARTIAL PATHNAME to the news folder on your hard drive, e.g. "MacintoshHD:UUPC:News" or just ":News"
  28.  
  29. "MAILDIR" -  the FULL OR PARTIAL PATHNAME to the mail folder on your hard drive, e.g. "MacintoshHD:UUPC:Mail" or just ":Mail"
  30.  
  31. "USERNAME" - your user-id, e.g. "rrwood"
  32.  
  33. "DEFAULT FONT" and "DEFAULT FONT SIZE" - the default font/size for text windows, e.g. "Courier" and "10".  This can be altered via a menu from within the program.
  34.  
  35. "NODENAME" - the name of your uucp node, e.g. "io"
  36.  
  37. "SEQUENCEFILE" - the name of the sequence file used by UUPC, e.g. "SEQF"
  38.  
  39. "CONFDIR" - the UUPC configuration directory, e.g. "MacintoshHD:UUPC:Config" or just ":Config"
  40.  
  41. "MAILSERVICE" - the name of your primary uucp neighbour node, e.g. "uuisis"
  42.  
  43. "SPOOLDIR" - the name of the UUPC spool directory, e.g. "MacintoshHD:UUPC:Spool" or ":Spool"
  44.  
  45. "DOMAIN" - your full uucp domain name, e.g. "io.org"
  46.  
  47. "TIMEDIFF" - your time difference, e.g. -0800 (PST)
  48.  
  49. "MAXMAILSIZE" - the maximum size (in bytes) of outgoing messages; mail larger than this size is split into multiple messages.  e.g. 30000
  50.  
  51. "MAXLINEWIDTH" - the maximum width in columns after which lines will be split (this is applied as the outgoing mail/article is spooled), e.g. 75
  52.  
  53. "SIGFILE" - name of a signature file which is automatically included at the end of the outgoing mail or news article
  54.  
  55. "ARTICLESFOLDER" - folder where saved articles will be stored by default
  56.  
  57. "REALNAME" - your name as you wish it to be displayed in the From: header line of your outgoing mail or news; e.g. ‚ÄúRoy Wood‚Äù
  58.  
  59. "ORGANIZATION" - user-specified value for the Organization: header line
  60.  
  61. "DISTRIBUTION" - user-specified value for the Distribution: header line
  62.  
  63. "REPLYTO" - user-specified value for the Reply-To: header line
  64.  
  65. "SHOWHEADER" - YES/NO to show article headers
  66.  
  67. "WRAPTEXT" - YES/NO to wrap text of displayed articles (only displayed articles; outgoing articles and mail are split according to MAXLINEWIDTH upon spooling)
  68.  
  69. "CUSTOMNEWSHEADER" - name of custom news header file (see below for more info)
  70.  
  71. "CUSTOMMAILHEADER" - name of custom mail header file (see below for more info)
  72.  
  73. "SAVEMAILFILENAME" - name of file to which a copy outgoing mail should be appended
  74.  
  75. "THREADPAUSE" - the number of ticks that rnMac should pause between attempting to thread all groups listed in the newsrc
  76.  
  77. "THREADLOG" - verbose/terse control for information displayed in thread log window
  78.  
  79. "SPOOLLOCAL" - yes/no flag to indicate whether to spool a copy of an outgoing article so that ToadNews will find and post it to the local system
  80.  
  81. "TEXTCREATOR" - a 4-character sequence that defines the creator signature assigned to textfiles created by rnMac; e.g. ¬´rn¬ª, KAHL, MSWD
  82.  
  83. "TEXTTYPE" - a 4-character sequence that defines the type signature assigned to textfiles created by rnMac; e.g. TEXT, ????, WDBN
  84.  
  85. "SAVEASSUBJ" - YES/NO to set default 'Save As Textfile' filename to subject of article or the name of the group
  86.  
  87. "DEFAULT WINDOWRECT" ‚Äî the default window size, specified as left  top  right  bottom  splitLocation; e.g. ‚Äú25  30  500 300 70‚Äù would specify the default window to have its top left corner at (25,5), its bottom right corner at (500,300) and the offset of the split pane marker as 70 (40 pixels below the top of the window)
  88.  
  89. "SHOWREHEADERS" ‚Äî YES/NO to show repeated headers in article list pane
  90.  
  91. "QUOTESTRING" ‚Äî the string of characters used to indent quoted text when replying to news/mail or when using the indented paste command under the Edit menu
  92.  
  93. "DOBLOCKPROCING" ‚Äî YES/NO to do threading in blocks (i.e. write all header info at once, rather than incrementally in the background, keep/discard all old headers at once, etc.)
  94.  
  95. "SAVEARTWINDPOS" ‚Äî YES/NO to save window positions for each individual newsgroup
  96.  
  97. "NEWSRCNAME" ‚Äî the name of the file in which the newsrc info is stored (i.e. currently subscribed groups and the read article numbers for each group); this is useful when more than one person is using the same copy of rnMac and you have multiple settings files)
  98.  
  99. "USETEXTEDIT" ‚Äî YES/NO to use TextEdit, rather than TE32K (the former limits you to editing text records smaller than 32K in size, though it may allow support for WorldScript....)
  100.  
  101. "TRUNCATEUUCPNAME" ‚Äî YES/NO to truncate the uucp name to six or fewer characters (this is required by older implementations of uucp)
  102.  
  103. "BACKGROUNDRGB" ‚Äî the red/green/blue colour settings for the background colour of the newsrc, articles, mail, outgoing mail, outgoing article windows (the other windows are just white-backgrounded since they are used so little)
  104.  
  105. "DOHZ2GBAUTO" ‚Äî YES/NO to perform HZ ‚Äî> GB conversion of subject lines and articles (HZ and GB are different forms of representing Chinese text, such as the postings to alt.chinese.talk)
  106.  
  107.  
  108.  
  109.  
  110. Aside from setting up the "rnMac SETTINGS" file, this program is pretty much just plug-and-play.  The menus are pretty easy to understand, and it works about the way you'd expect it to.  Just double-click everything in sight and you should be fine.
  111.  
  112. To subscribe to groups, choose "Show All Newsgroups" under the Groups menu, double-click on the group you're interested in, and then choose "Subscribe" from the Groups menu.  When you subscribe to a group, it is not automatically opened, though you can modify this if you hold down the option key as you double-click.  Subscribing to a group simply adds its name and some other information to the newsrc file.  (The newsrc file is pretty much identical to its Unix counterpart, and can be edited with any text editor.)  Lots of people have suggested allowing shift-clicking to select multiple groups for subscribing, but it's so easy to quickly option-click a bunch of groups that I'm not going to bother.
  113.  
  114.  
  115. If you wish to remove a group from your newsrc, click once on it in the "Subscribed Groups" window (it will be highlighted), and then choose "Unsubscribe" from the Newsgroups menu.  You can also shift-click to select multiple groups to unsubscribe.
  116.  
  117.  
  118. The "Articles" menu allows you to do a lot of useful things within a group window (e.g. kill subjects, list all subjects, follow a subject thread, etc.).  If you are playing around with the status of articles, you will notice that they are flagged with a check to indicate that they are marked as read in your newsrc file.  You can also option-click an article's header to toggle its read/unread status.  You can also shift-click to select multiple article subjects.
  119.  
  120.  
  121. The "Text" menu is primarily used to set the default font/size of text by altering the "DEFAULT FONT" and "DEFAULT FONT SIZE" resources in the "rnMac SETTINGS" file.  By default, the font and size of text in all windows is affected, though this can be overridden.  In order to change the font/size for just the front window (and not the defaults!), hold down the option key as you make your menu selection.   Via a stroke of serendipity, rnMac allows the text in every window to appear in a different font/size, though I can't imagine why anyone would want to do so (maybe rec.humor.funny in San Francisco?).  And yes, rnMac even remembers fonts/sizes between sessions!  (use ResEdit to discover the secret undocumented 'STR ' resources....)
  122.  
  123.  
  124. rnMac does an acceptable job of acting as a mail-reader, too.  You can read and send mail, and even do some nice things like save and edit messages as standard Mac text files.  You will be delighted to note that you can now edit files larger than 32K in size!  (Boy, was that a nuisance to get working.)  To use this feature, you should turn off the use of TextEdit (there's an option under the Edit menu).
  125.  
  126.  
  127. The aliasing features available via the "Send Mail To:" menu option allow you to define new aliases, edit or delete old aliases, or just send mail to an aliased address.  The catch is that the alias is expanded into the full address when the outgoing mail window is created, so you can't really add names to the "To:" or other header lines.  However, you can define an alias to include multiple target addresses (e.g. define alias "friends" as "rrwood@io.org, jpmah@descartes.uwaterloo.ca").  Note that aliases are NOT expanded recursively, so you can't define "roy" as "rrwood@io.org" and "john" as "jpmah@descartes.uwaterloo.ca", and then define "friends" as "roy john".  The "rnMac Aliases" file is just a textfile, so you can edit it manually, or use rnMac to make changes.
  128.  
  129. rnMac will split outgoing mail (not articles....yet) into smaller pieces whose size is dictated by the MAXMAILSIZE setting.  Note that this size restriction is approximate at best, and does not account for the mail header!
  130.  
  131. The mailbox routines are smart enough to automatically recognize the presence of new mail.  As for new articles, well they are shown once the background threading is updated (i.e. if ToadNews is running in the background and it unbatches a new article for the group you are reading, then the thread file for that group has to be updated before the new article is listed in the open window; conversely, if you open a new group for which the thread file is out of date, the ToadNews 'SUBJ' resources will be used and all articles will be shown).  And yes, this background threading is kind of kludgy, but John Mah says he'll do some magic with ToadNews that should improve things.
  132.  
  133.  
  134. For those of you who insist on creating custom headers for your mail/news, that capability has been added.  Add and set the "CUSTOMMAILHEADER" or "CUSTOMNEWSHEADER" setting to the name of your custom header file, and rnMac will use your header.  Of course, for this to be really useful, you will probably want to use some of the following macros in your header (the names are fairly self-explanatory): NODENAME, MAILSERVICE, DOMAIN, TIMEDIFF, USERNAME, REALNAME, DISTRIBUTION, ORGANIZATION, REPLYTO, GROUPNAME, TOADDRESS, SUBJECT, REFERENCES, TICKTIME, DAYNUM, MONTHNUM, DAYNAME, MONTHNAME, HOUR, MINUTE, SECOND, YEAR, TWODIGITYEAR, SEQFNUM.  To invoke a macro in your header, just use a percent symbol (%) followed by the macro name in capitals.  When rnMac reads in your header file, it replaces the macro with the appropriate string; e.g. "%REALNAME" would be replaced by "Roy Wood" on my machine.  As you may have guessed, if you want to place a percent symbol in your header, just type it twice, e.g. "%%".  The end of the header, as recognized by rnMac, is the first empty line in the message (i.e. the first line consisting solely of a carriage return).
  135.  
  136. If you're having trouble with custom headers, take a look at the default header lines, and read RFC-822, RFC-1036, and RFC-976 (stop complaining ‚Äî if you want to do fancy stuff, you have to be prepared to put in a little effort).  Note that rnMac does not modify custom headers in any way when they are spooled, so what you see in the edit window is what will be used as the message header!
  137.  
  138.  
  139.  
  140. I'm still working on improving rnMac, so drop me a note with your suggestions for improvement.  Currently, I can be reached as ‚ÄúRoy_R._Wood@magic-bbs.corp.apple.com‚Äù or ‚Äúrrwood@io.org‚Äù.  If you're interested, I'm planning to make rnMac compatible with LocalTalk NNTP servers, which will make things simple for anyone wishing to provide news/mail on a LocalTalk network.  Right now you can do this by setting up a file-server (or shared volume with system 7) with the news files on it, and then just fiddle with the SETTINGS file to point to the server.  Things will work best if you leave a copy of rnMac running on the server (it will keep the thread files up-to-date on the server) and make sure that your Mac has a hefty disk cache (e.g. my wife's PB140 will process about 500 articles per minute with a 256K cache; results without a big cache are abysmal (think about what the Mac HFS is doing to keep track of those folders with 1000+ article files in them!)).
  141.  
  142.  
  143. Version History:
  144.  
  145. June 16 - v 1.3b4
  146. - fixed bad dereference of Handle in threader code (this caused nasty crashes during threading)
  147. - fixed long vs unsigned long problems in threader code
  148. - added GB2HZ processing for From: author names
  149. - added better internal safeguards to catch and correct bad newsrc's
  150. - added code to reject font sizes less than zero
  151. - fixed custom header code
  152.  
  153.  
  154.  
  155. June 12 ‚Äî v1.3b3
  156. - changed font of this help text to Courier, which I hope everyone has installed
  157. - fixed call to ObscureCursor() after keystrokes
  158. - added support for "Open Document" Apple Events, so double-clicking on a settings file now works under System 7 again
  159. - fixed the bug in the newsrc code that was responsible for trashing the lists of read articles (for those interested, the problem was due to a long vs unsigned long article number when doing comparisons; after testing 100,000 mark as read/mark as unread operations, I'm reasonably confident that things are solid now)
  160. - fixed a really wicked bug with the default font size and font menu that occasionally set the font size to -1, which lead TextEdit to believe that it was dealing with a styled edit record, rather than a standard edit record (let's hope this makes John Delacour's life easier)
  161.  
  162.  
  163.  
  164.  
  165. June 1 - v1.3b2
  166. - fixed problem with loading sigfile when posting an article (thanks Ernst!)
  167. - added Subject/Date threading feature (works fast and sort of well)
  168. - enabled Edit menu choices (Cut/Copy/Clear) after shift-arrowkey selection of text
  169. - when saving articles, rnMac now checks to see if the file exists, and gives the user the option to append or overwrite the file when appropriate
  170. - added NEWSRCNAME setting and multi-user capabilities
  171. - added code to recognize open documents, so you can double-click on a settings file to launch rnMac
  172. - fixed problem with rmail command for headers like ‚ÄúTo: rrwood@io.org (Roy Wood)‚Äù or ‚ÄúTo: Roy Wood <rrwood@io.org>‚Äù (according to RFC 1036, those are the only legal forms that caused problems)
  173. - fixed up the ‚ÄúSave As Textfile‚Äù code for saving multiple articles
  174. - when saving textfiles and using the article subject as the filename, colons are now translated to spaces, so as not to confuse the file manager
  175. - the system part of the filenames of spooled UUCP files are now truncated to 6 or fewer characters, so as not to confuse older (traditional?) UUCP implementations; let's hope this doesn't upset MacSlurp
  176. - support for multiple monitors has been implemented, I think (can someone test this for and let me know if it works, please?)
  177. - help screen is now non-modal
  178. - settings editing screen is now non-modal
  179. - better tolerance for missing settings implemented (uses defaults in application resource fork, making it easier to update old settings files now)
  180. - text font/size menu now works correctly
  181. - added support for "USETEXTEDIT" setting, which may provide support for WorldScript (can someone let me know if they can get a non-english system such as Chinese or German to work?)
  182. - added ISO-8859 translation using A. Pirard's 'taBL' resource tables
  183. - added support for "TRUNCATEUUCPNAME" setting
  184. - if an original article has been deleted and the alias is then opened, that article is now marked as read, and hilighting of the article header in the list is correctly handled
  185. - "Save Newsrc" menu option is back
  186. - pasting in the registration dialog is enabled
  187. - added support for "BACKGROUNDRGB" setting and setting the background colour via the colour picker on machines with colour QuickDraw
  188. - fixed WRAPTEXT handling in TextEdit mode (remember this only affects displayed articles, not outgoing news/mail)
  189. - added GB <‚Äî> HZ conversion code for Chinese text (I hope it works!)
  190. - added support for DOHZ2GBAUTO setting
  191. - added silly little emoticons menu for pasting into outgoing mail/news; to customize the available items, use ResEdit or Resourcerer....
  192. - added support for required Apple Events (Open Application, Open Document, Print, Quit) and ToadNews "thread all newsgroups" events, so rnMac now functions correctly as a ToadNews-invocable threader (i.e. when it receives the appropriate Apple Event from ToadNews, it threads all newsgroups and then quits)
  193.  
  194.  
  195.  
  196.  
  197.  
  198.